package com.winit.distributed.lock;

import java.util.concurrent.TimeUnit;

/**
 * @author liuming.li
 * @date 2023-03-21
 */
public interface DistributedLock {

    /**
     * 阻塞式获取锁
     *
     * @param lockKey 锁的唯一标识
     * @param leaseTime 锁的生效时长
     * @param unit 时间单位
     */
    void lock(String lockKey, long leaseTime, TimeUnit unit);

    /**
     *  尝试获取锁，阻塞式等待 waitTime
     *
     * @param lockKey 锁的唯一标识
     * @param waitTime 获取锁阻塞时间
     * @param leaseTime 锁的生效时长
     * @param unit 时间单位
     * @return true: 获取锁成功；false：获取锁失败
     */
    boolean tryLock(String lockKey, long waitTime, long leaseTime, TimeUnit unit);

    /**
     * 释放锁
     *
     * @param lockKey 锁的唯一标识
     */
    void unlock(String lockKey);
}

